Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Reporting Information to the User

GXReportStatus

You can use the GXReportStatus function to display information to the user in the desktop printer window.

OSErr GXReportStatus ( short statusId, 
                       unsigned short statusIndex);

statusId

The ID of the status ('stat') resource that contains the status strings.

statusIndex

The index of the status string that you want displayed.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

You call the GXReportStatus function to display informational feedback to the user during the printing of a document. You need to specify the ID of the status resource in which the feedback string is stored.

If the information that you want to display requires user attention, you need to call the GXAlertTheUser function instead.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.
gxUnknownAlertVersionErr	The printing alert version specified in the resource is not valid.

SEE ALSO

You can find an example of using the GXReportStatus function in Listing 3-15 on page 3-42 in the chapter "Printer Drivers."

You can read about status resources in the section "The Status ('stat') Resource" beginning on page 6-19 in the chapter "Printing Resources."

You can read about displaying status information in the section "Displaying Status Information and the Printing Alert Boxes" beginning on page 5-4. You can also read about this task in the section "Displaying Status Information and the Printing Alert Boxes" beginning on page 3-41 in the chapter "Printer Drivers."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help